importSongs

Adds new songs to the database.

Sample Request

<mmRequest command="importSongs" station="ID" [version="1"] [client=""] [userData=""]>
	<contents>
		<songList>
			<song>
				<field id="108">NewValue</field>
			</song>
		</songList>
		[<fields>
			<field id="101" />
			<field name="Title" />
		</fields>]
	</contents>
</mmRequest>

Request Notes

The actual update request is provided in the contents/songList section.

 

song – You must add a song tag for each song you wish to add. The song tag includes the information you wish to import for this new song in one or more field tags. You should only include field tags for the fields you wish to update on the new songs. Any default values will be replaced with the data provided. The field tag requires an id attribute with internal field ID number, or a name attribute with the user-defined field name. You can obtain a list of available fields with the command. The value of the tag should be the data you want to write to the database.

 

fields - The fields section must contain one field tag for each song field you wish to include in the reply message. You can use the id attribute with the internal field ID codes, or a name attribute with the user-specified field name. Only the specified fields will be returned for each song. However, the internal song ID number will always be included in the reply. You can obtain a list of available fields with the command.

 

Note that the fields section is optional. If not specified, only the song id, runtime and the primary and secondary fields will be returned. Typically, primary and secondary fields are defined as title and artist.

Sample Reply

<mmReply command="importSongs" station="Jill's Seminar Data" userData="hello" status="ok">
	<contents>
		<songList recordCount="1">
			<song songId="511">
				<field id="12" name="Run Time">01:45</field>
				<field id="102" name="Artist">Artist Name</field>
				<field id="134" name="Title">Song Title</field>
			</song>
		</songList>
	</contents>
</mmReply>

Reply Notes

The list of songs imported is returned in the contents/songlist section.

 

Each song has a song tag. The songId attribute contains the MusicMaster internal song ID for each song. One or more field tags may be included with the value of each requested field. The field tags include an id attribute with the internal field ID number and a name attribute with the user defined field name.

 

When the songID is returned we recommend you save that data field in your system. It provides a discreet way to reference the songs between systems.

Compatibility and Version Info

Available in all versions